home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / pdselect / awnp / awnp-docs / penmap.doc < prev    next >
Text File  |  2000-02-16  |  2KB  |  58 lines
  1. PenMap parameters
  2. -------------------
  3.  
  4. The penmap keyword does not produce a gadget.  It creates an image to be used later. Up to 10 images can be predefined, the last one defined is the first one used. Last In First Out.
  5.  
  6. bindata (bd)
  7.  
  8. The PenMapPalette,penmapdata, and selectedimage  will be passed to this pipe in binary after the command line, AND IN THAT ORDER. The penmapdata,selectedimage, and PenMapPalette parameters now give the length of each data segment. Do NOT specify a data length of 0 for selected image, omit the keyword instead.
  9.  
  10. dataout="filename" (do)
  11.  
  12.  Send the data for this gadget to a file. This is a development tool to allow you to create binary data to pass to the pipe. It is ignored if the Bindata keyword is also present.
  13.  
  14. penmapdata="data" (pmd)
  15.  
  16. The image data. NOTE all values are ascii HEX. The data is in the following format.
  17.  
  18. "width_h_byte|width_l_byte|height_h_byte|height_l_byte|data1|data2..."
  19.  
  20. If the bindata keyword is used the image data is the following format
  21.  
  22. word width, height;
  23. char data[];
  24.  
  25. Note the size specified in penmapdata INCLUDES the 4 bytes for width and height.
  26.  
  27. selectedimage="data" (si)
  28.  
  29. The image data for a selected image. NOTE all values are ascii HEX. The data is in the following format.
  30.  
  31. "width_h_byte|width_l_byte|height_h_byte|height_l_byte|data1|data2..."
  32.  
  33. If the bindata keyword is used the image data is the same format as
  34. for penmapdata.
  35.  
  36. PenMapPalette="data" (pmp)
  37.  
  38. The palate data. NOTE all values are ascii HEX. The data is in the following format.
  39.  
  40. "triplet_count|red1|green1|blue1|red2|..."
  41.  
  42. If the bindata keyword is used the palate data is the format
  43.  
  44.            ULONG palette[] =
  45.            {
  46.                number_triplets,
  47.                red1, green1, blue1,
  48.                red2, green2, blue2,
  49.                ...
  50.            };
  51.  
  52.  
  53.  
  54. Trans
  55.  
  56.  Make pen 0 transparent.
  57.  
  58.